Postman is a Chrome application that makes it easy to test API calls thanks to it's use of variables. If you don't have Postman already, you can download it from https://www.getpostman.com/.
In Postman, create a new environment with variables like these
Now, those variables can be used with requests. Create a new POST with a url to
http://{{server}}:8018/icws/connection
The {{server}} will be replaced with value in the environment configuration.
Next add a header for Content-Type application/json and Accept-Language then set the body of the POST to
1
2
3
4
5
6
{
"__type":"urn:inin.com:connection:icAuthConnectionRequestSettings",
"applicationName" :"Postman",
"userID": "{{user}}",
"password" : "{{password}}"
}
and click Send. Now would be a good time to click Add to collection to save this request for later.
The response should now look something like this.
1
2
3
4
5
6
7
8
9
10
{
"csrfToken": "WA1rZXZpbi5nbGluc2tpV1Bvc3RtYW5YJGE3ODU1OWViLTI1YzMtNGQ3Ni05Nzg4LWZmNWQ3NGEwY2QzZVgMMTcyLjE3LjQ4LjUy",
"sessionId": "1139184001",
"alternateHostList": [
"Morbo.DEV2000.com"
],
"userID": "kevin.glinski",
"userDisplayName": "Kevin Glinski",
"icServer": "MORBO"
}
Now you can right click on the value of sessionId and save it to the sessionId variable, do the same with the csrfToken, make sure to copy the entire value.
These variables can not be used in future calls.
Let's create a new request to get information about the current user. Create a new GET request now with the url
http://{{server}}:8018/icws/{{sessionId}}/status/user-statuses/{{user}} and the headers of
| ININ-ICWS-CSRF-Token |
{{csrfToken}} |
|---|
and click Send again. Congratulations, you are now on your way to testing out the APIs.